pp108 : Creating XForms using XML Schema Fragments

Creating XForms using XML Schema Fragments
This topic describes the procedure to create XForms using schema fragments.

Process Platform supports the use of Schema Fragments to create user interfaces (for outputs) in XForms.

This is useful in cases where XForms are not associated with a WSDL, making it difficult to map them for outputs in a process. In such cases, you can add a schema fragment to XForms, making them visible in the message map for mapping. While generating an HTML definition, Process Platform XForms interprets the schema for a business object and combines any validation defined for it. When you enter a value in the XForm at run time, the value is validated and an alert displays if the validation fails.

  1. Select a starting point and click (User Interface) to create XForms using schema fragments. The Untitled User Interface - User Interface App Palette appears and the XForms Designer displays.
  2. Drag the appropriate schema fragment to the XForm from the Schema Fragment group in the Insert tab. Alternately, right-click the Designer Area of the XForm, select Insert > Insert Schema Fragment, and drag the Schema Fragment from the Select Schema Fragment dialog box that appears. This right-click menu option is available for a split area, an XForm, and for the Group, Groupbox, and Tab Page grouping controls. The Generate Output UI dialog box appears.
  3. Select Generate UI for Output to generate an output UI. The UI is displayed in the Designer Area. You can modify the XForm as required. A model is created for the schema fragment added to the XForm.
  4. Click to save the XForm. The Untitled User Interface - User Interface dialog box appears.
  5. Type the name of the XForm in the Name field. The name of the XForm must begin with a letter of the alphabet or an underscore, and can contain only letters, numbers, and underscores. A name that begins with an underscore must contain at least one letter or number. The user interface name cannot contain multi-byte characters.

    CAUTION
    Ensure that the names that you specify are not the same as the names of the predefined XForms in the application.

  6. Type a description for the XForm in the Description field. The description can contain only letters, numbers, and special characters such as periods (.), commas (,), parenthesis (()), single quotation marks ('), hyphens (-), and underscores (_).
  7. In the Location field, select . The Select Folder dialog box opens.
  8. Specify the location at which the XForm must be saved in the Select Folder dialog box, and click OK. The Select Folder dialog box closes.
  9. Select Save in the Untitled User Interface - User Interface dialog box. The Untitled User Interface - User Interface dialog box closes.

An XForm is created and saved. You can use the preview feature to preview the XForm. To do so, click (Preview) in the toolbar.

Note:

  • If the schema of a schema fragment that is being used in an XForm is changed, the change will not be automatically reflected in the XForm. In this case, you must again add the modified schema fragment to the XForm.
  • You can also add a schema fragment to an XForm using the Model Properties dialog box. For details, see Model Properties dialog box.
  • For information about creating schema fragments, see Creating Schema Fragments.

After you complete this task:
After creating an XForm, you can customize it and translate it in various languages, as required. You can also publish it to use it in an application.